[Day 5] VS Code + Gitlab MCP 環境建置實戰 - 啟動 gitlab mcp server

17th鐵人賽

tom_yukuan

2025-09-09 00:03:57

80 瀏覽

分享至

VS Code + MCP 環境建置實戰 - 啟動 gitlab mcp server

前言

經過前兩天對 MCP 概念和架構的深入了解，今天我們要進入實戰階段！這篇文章將帶你一步步建置 VSCode + MCP 的開發環境，讓 AI 助手能夠直接存取你的 GitLab 專案資料。

說明：對於較常見的基礎操作（如 VSCode 安裝），我會提供參考連結，重點放在 MCP 相關的設定步驟上。

步驟

步驟 1: 安裝基礎環境

VSCode 與 Copilot 安裝
請參考這篇詳細教學：安裝 VSCode 與 GitHub Copilot
其他 IDE 支援

Cursor：同樣支援 MCP，設定方式類似
JetBrains 系列：部分產品支援，但本系列以 VSCode 為主
Claude Desktop(非 IDE)：原生支援 MCP，可作為替代方案

步驟 2: 取得 GitLab Access Token

GitLab 提供兩種 Token 類型，根據你的使用需求選擇：

Personal Access Token（個人存取權杖）

適用場景：個人開發，需要存取多個專案
取得方式：
1. 登入 GitLab → 右上角頭像 → Preferences
2. 左側選單 → Access Tokens
3. 建立新的 Token，選擇所需權限
  - api (完整 API 存取)
  - read_user (讀取使用者資訊)
  - read_repository (讀取程式碼庫)

Project Access Token（專案存取權杖）

適用場景：限定特定專案，權限控制更精確
取得方式：
1. 進入目標專案 → Settings → Access Tokens
2. 建立專案專用的 Token

安全提醒：Token 具有敏感權限，請妥善保管，不要提交到程式碼庫中！

步驟 3：設定 VSCode MCP 設定檔

我們使用 zereight 的 Gitlab MCP Server，這是我目前功能找到最完整的開源方案。

建立設定檔

根據你使用的編輯器，在對應位置建立設定檔：

VS Code

mkdir -p ~/.vscode
touch ~/.vscode/mcp.json

Cursor

mkdir -p ~/.cursor  
touch ~/.cursor/mcp.json

設定檔內容

將以下內容貼入 mcp.json：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gitlab-token",
      "description": "GitLab Token (api scope)",
      "password": true
    }
  ],
  "servers": {
    "gitlab-review": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab",
        "--disabledTools",
        "create_or_update_file,push_files,create_repository,fork_repository,search_repositories,create_branch,list_group_projects,list_group_iterations"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "你的_ACCESS_TOKEN",
        "GITLAB_API_URL": "你的_GITLAB_網址/api/v4",
        "GITLAB_PROJECT_ID": "你的_PROJECT_ID（選填）"
      }
    }
  }
}

參數說明

參數	說明	範例
GITLAB_PERSONAL_ACCESS_TOKEN	步驟2取得的Token	glpat-xxxxxxxxxxxx
GITLAB_API_URL	GitLab API 端點	https://gitlab.com/api/v4
GITLAB_PROJECT_ID	專案ID (選填)	12345